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5- TECHNICAL FIELD 

This invention is related to application program interfaces and the use thereof. 



BACKGROUND OF THE INVENTION 
Traditionally, there exist software tools that are stand-alone, yet when utilized 
10 together can provide a more cohesive and greatly improved user experience. Such 
environments offers a mean for third party vendors and others to provide tools that 
enhance application and document development. 

What is needed is a linking architecture that allows access of features of 
non-integrated tools. 

15 

SUMMARY OF THE INVENTION 
The following presents a simplified summary of the invention in order to provide 
a basic understanding of some aspects of the invention. This summary is not an extensive 
overview of the invention. It is not intended to identify key/critical elements of the 

20 invention or to delineate the scope of the invention. Its sole purpose is to present some 
concepts of the invention in a simplified form as a prelude to the more detailed 
description that is presented later. 

The present invention disclosed and claimed herein, in one aspect thereof, 
comprises architecture that facilitates the integration of non-integrated applications, 

25 services, or tools. The disclosed Integration Services (IS) is a lightweight architecture for 
allowing loosely-coupled and individually-architected tools to offer simple data 
integration through a combination of technology and conventions. It thus provides some 
of the core benefits offered by a common repository without the repository itself. For 
example, the IS includes source control and defect tracking, each of which was designed 

30 separately with different principles in mind. By introducing a standard way to identify 
the major items each tool makes public (i.e., their artifacts), it is possible for defects, for 
instance, to point to source control (and vice versa) without either tool holding intimate 
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knowledge of the other. Moreover, third parties can introduce new tools to the IS with 
their own, specialized links, to enable lightweight data integration without any 
modifications to the IS tools. 

Disclosed is a set of Application Programming Interfaces (APIs) and conventions 
"5. used to enable integration between tools that were not architected to be integrated. This 
solution provides a substantial portion of the benefits of a repository for a small fraction 
of the cost and commitment to participants. It provides architecture for server-based 
partner-integration and client-integration for development tools. 

In support thereof, there is provided a system that comprises an artifact provider 
1 0 that exposes artifacts of one or more disparate applications, and an artifact consumer that 
exposes references associated with a link to the artifacts of the artifact provider. A 
linking component facilitates linking the provider artifacts and the consumer references. 

In another aspect of the present invention there is provided a link cache that 
caches artifacts and artifact references, and links. 
1 5 In yet another aspect thereof, a user interface is provided that facilitates 

presenting inter-artifact references. 

In still another aspect of the present invention, there is provided a link manager 
that at least facilitates cache synchronization with each tool. 

In another aspect thereof, there is provided a generic artifact provider (GAP) 
20 where all methods from an artifact provider and consumer are implemented by the GAP. 
An artifact in generic artifact schema-format is pushed into a GAP database. 

To the accomplishment of the foregoing and related ends, certain illustrative 
aspects of the invention are described herein in connection with the following description 
and the annexed drawings. These aspects are indicative, however, of but a few of the 
25 various ways in which the principles of the invention can be employed and the present 
invention is intended to include all such aspects and their equivalents. Other advantages 
and novel features of the invention will become apparent from the following detailed 
description of the invention when considered in conjunction with the drawings. 

30 BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 illustrates a system of the present invention. 
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FIG. 2 illustrates a flow chart of a process in accordance with the present 
invention. 

FIG. 3 illustrates a linking pattern of a consumer and provider and, referring and 
referenced artifact associations. 
5. FIG. 4 illustrates a user interface (UI) that facilitates the presentation of artifact 

dependencies. 

FIG. 5 illustrates a block diagram of one implementation of a GAP API in 
accordance with the present invention. 

FIG. 6 illustrates a flow chart of one implementation for preparing a non- 
1 0 integrated tool for using the GAP. 

FIG. 7 illustrates a generic artifact database schema (GADS) used for both the 
GAP and a cache. 

FIG. 8 illustrates a flow chart of one method of implementing the GAP in 
accordance with the present invention. 
1 5 FIG. 9 illustrates a flow chart of one method of implementing a GAP adapter in 

accordance with the present invention. 

FIG. 10 illustrates a system that facilitates accessing non-integrated tools in 
accordance with the present invention. 

FIG. 1 1 illustrates a flow chart of a process for one implementation of a cache in 
20 accordance with the present invention. 

FIG. 12 illustrates a block diagram of a computer operable to execute the 
disclosed architecture. 

FIG. 1 3 illustrates a schematic block diagram of an exemplary computing 
environment in accordance with the present invention. 

25 

DETAILED DESCRIPTION OF THE INVENTION 
The present invention is now described with reference to the drawings, wherein 
like reference numerals are used to refer to like elements throughout. In the following 
description, for purposes of explanation, numerous specific details are set forth in order 
30 to provide a thorough understanding of the present invention. It may be evident, 

however, that the present invention can be practiced without these specific details. In 
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other instances, well-known structures and devices are shown in block diagram form in 
order to facilitate describing the present invention. 

As used in this application, the terms "component" and "system" are intended to 
refer to a computer-related entity, either hardware, a combination of hardware and 
5. software, software, or software in execution. For example, a component can be, but is 
not limited to being, a process running on a processor, a processor, an object, an 
executable, a thread of execution, a program, and/or a computer. By way of illustration, 
both an application running on a server and the server can be a component. One or more 
components can reside within a process and/or thread of execution, and a component can 

1 0 be localized on one computer and/or distributed between two or more computers. 

As used herein, the term to "infer" or "inference" refer generally to the process of 
reasoning about or inferring states of the system, environment, and/or user from a set of 
observations as captured via events and/or data. Inference can be employed to identify a 
specific context or action, or can generate a probability distribution over states, for 

1 5 example. The inference can be probabilistic-that is, the computation of a probability 

distribution over states of interest based on a consideration of data and events. Inference 
can also refer to techniques employed for composing higher-level events from a set of 
events and/or data. Such inference results in the construction of new events or actions 
from a set of observed events and/or stored event data, whether or not the events are 

20 correlated in close temporal proximity, and whether the events and data come from one 
or several event and data sources. 

DEFINITIONS 

The following terms are used throughout the description, the definitions of which 
25 are provided herein to assist in understanding various aspects of the subject invention. 

Artifact: Any item of data a tool exposes publicly so that other tools can hold 
pointers to it. Each artifact must be of an artifact type. Each artifact must be identified 
by a unique and immutable artifact identifier. Examples: source file foo.cs, work item 
125, test results from build 20041205.3. 
30 Artifact Consumer: Informally, a tool or service that exposes references it holds 

to artifacts that are hosted by artifact providers. More formally, a service that exposes 
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references it holds to artifacts that are hosted by artifact providers. For instance, C's 
work item (itself an artifact) can hold references to P's change sets that were checked in 
as the work item was being processed. In this case, C is the artifact consumer and P is 
the artifact provider. An artifact consumer must offer certain standard behaviors. Note 
5. that, since by definition a link is between two artifacts, an artifact consumer must also be 
an artifact provider. 

Artifact Identifier: An objectified version of the unique, immutable identifier for 
a particular artifact (ArtifactUri). The properties in an artifact identifier conform to the 
rules for URIs. 

10 Artifact Provider: Informally, a tool or service that hosts and exposes artifacts to 

which an artifact consumer can link. More formally, it is a service that exposes artifacts. 
For instance, C exposes artifacts of type defect, requirement, and task through web 
services, making it an artifact provider. An artifact provider must offer certain standard 
behaviors. Note that, since by definition a link is between two artifacts, many artifact 
1 5 providers can also be artifact consumers. 

Artifact Proxy: An artifact stored by a Generic Artifact Provider (GAP) that 
represents data stored in a non-integrated service enabled store. 

Artifact Type: A type of data a tool exposes publicly. An artifact of a particular 
artifact type has a common set of link types with other artifacts of that type. Examples 
20 include, but are not limited to, a source file, defect, requirement, test result, and build. 

Artifact URI: A Uniform Resource Identifier that conforms to specific rules for 
well formedness. Synonym of Integration Services (IS) Uri. 

Integration Services (IS) - The disclosed lightweight architecture that allows 
simple data integration of loosely-coupled and individually-architected non-integrated 
25 tools through a combination of technology and conventions. Any service or tool that has 
not been enabled by the IS architecture is termed "non-IS" or also, non-integrated. 

IS Namespace: A namespace that corresponds to a collection of IS-enabled 
products and artifacts, that can be thought of as a "logical server, " where its physical 
elements can be scattered across multiple physical servers. Tools register themselves 
30 with an IS Namespace at installation time, and all tools are accessible through the IS 
location table. Each artifact is owned by one IS Namespace. 
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IS Uri: A Uniform Resource Identifier that conforms to IS-specific rules for well 
formedness. Synonym of ArtifactUri. 

External Identifier: Meaningful in the context of the IS GAP. Refers to the 
identifier by which a non-IS enabled tool refers to an artifact. 
5- Generic Artifact Provider (GAP): The IS GAP is an IS-provided facility that 

enables construction of artifact proxies to impart artifact-handling behavior to tools that 
are not fully IS-enabled. 

Generic Artifact Schema (GAS): A common schema for describing a collection 
of artifacts. Each artifact includes its extended attributes and the links it holds to other 
10 artifacts. 

Generic Link Schema (GLS): A common schema for describing a collection of 
links. Each link includes its referring and referenced ArtifactUris, and its link type. 

Inbound Link: A link from the standpoint of the referenced artifact (i.e., the 
artifact being pointed to). Inbound links to a referring artifact can be discovered using 
1 5 the standard GetReferencingArtifacts method used for implementation by artifact 
consumers. 

Link: An artifact identifier held by an artifact consumer to point to an artifact. A 
link is binary and involves exactly two artifacts, the referring artifact and the referenced 
artifact. A link is formed when a tool (an artifact consumer) holds an artifact identifier to 
20 a different artifact. Each link must be of a link type. Note that a well-formed link is 

between two artifacts, the referring artifact and the referenced artifact. A pointer between 
an artifact and a non-artifact is not a link. Example: bug 125 was found in build 
20041205.4, where "bug" and "build" are artifact types and '"was found in" is a link type. 
Link Type: Describes the purpose of links of that type. May constrain the artifact 
25 type of artifacts to which valid links can be constructed. Each link includes two readings 
(or roles), one from each (outbound and inbound) direction. For instance: bug 125 was 
found in build 20041205.4 vs. build 20041205.4 exposed bug 125. 

Loose Coupling: In the context of linking, a quality of behavior that does not 
require either the artifact provider to have knowledge of any artifact consumers. For 
30 instance, when an artifact provider issues a reference inversion query using a IS cross- 
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service inversion query tool, IS returns a set of references according to a schema that is 
common to all artifacts. 

Outbound Link: A link from the standpoint of the referring artifact (i.e., the 
artifact that points to some other artifact). Outbound links to a referenced artifact are 
5. returned by the standard GetArtifacts method required for implementation by artifact 
providers. 

Reference Inversion (also inversion query): In general, reference inversion is the 
process of discovering what items hold pointers to (refer to) a specific item. In IS, it is 
the process of discovering which referring artifacts hold links to a specific referenced. 

10 Referenced Artifact: Used in the context of a link. The referenced artifact is the 

side of the link to which the referring artifact points. A referenced artifact is always 
hosted by an artifact provider. 

Referencing (or Referring) Artifact: Used in the context of a link. The referring 
artifact is the side of the link that holds the reference to a referenced artifact. It is hosted 

15 by an artifact consumer. 

Tight Coupling: In the context of linking, a quality of behavior that requires the 
artifact consumer to have specific knowledge about the artifact provider. For instance, if 
the provider offers a specialized reference inversion method (perhaps it includes special 
filters or passes back specific information of particular interest to the subject consumer) 

20 and the consumer takes advantage of it, that interaction is said to be tightly coupled. 

Tool-specific Id (TSId): The final part of a well formed IS Uri. The combination 
of tool instance, artifact type, and tool-specific Id must be unique within a IS Namespace. 
Further, the TSId must be immutable. 

Referring now to FIG. 1, there is illustrated a system 100 of the present invention. 

25 For purposes of this description, there are provided only two non-integrated tools (or 

services, but hereafter, collectively called a tool): a first tool 102, and a second tool 104. 
However, it is to be understood that there can be any number of non-integrated tools 
available that can be enabled to interact by employing one or more interfaces in 
accordance with the present invention. In this implementation, the first tool 102 will be 

30 designated a provider, and the second tool a consumer. Since both tools (1 02 and 1 04) 
are non-integrated tools, the interfaces of the present invention facilitate exposing data of 
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these tools (102 and 104), as can be done with integrated tools. The exposed data is in 
the form of artifacts, and references to these artifacts. In support thereof, an artifact 
provider interface 106 (in the form of, for example, an application programming 
interface-API) is implemented with the first tool 102 that facilitates exposing one or more 
5- artifacts 108 (denoted ARTIFACT,, ARTIFACT 2 ,...,ARTIFACT N ) of the first tool 102. 
The second tool 104 will be designated a consumer of the artifacts 108. In accordance 
with the present invention, there is provided an artifact consumer interface 1 10 that 
exposes one or more references 1 12 (denoted REFERENCE , 5 

REFERENCE 2 ,.. .,REFERENCE M ) of the second tool 104 that can reference the one or 

1 0 more artifacts 1 08 of the first tool 1 02. 

The artifacts 108 of the first tool 102 are associated to the references 1 12 of the 
second tool 104 by a linking component 114. The linking component can be part of the 
consumer interface 110; however, this is not required. The linking component 1 14 
defines a link that includes an artifact identifier that points to at least one of the artifacts 

15 108. The link is of a link type, and is binary, in that, it involves two artifacts: a referring 
artifact, and a referenced artifact. 

Thus, the disclosed architecture comprises a set of APIs and conventions used to 
enable integration between tools that were not previously architected to be integrated. 
This provides the basis for server-based partner integration and client integration of tools, 

20 and can facilitate the foundation for building a third-party ecosystem. 

Referring now to FIG. 2, there is illustrated a flow chart of a process in 
accordance with the present invention. While, for purposes of simplicity of explanation, 
the one or more methodologies shown herein, e.g., in the form of a flow chart, are shown 
and described as a series of acts, it is to be understood and appreciated that the present 

25 invention is not limited by the order of acts, as some acts may, in accordance with the 

present invention, occur in a different order and/or concurrently with other acts from that 
shown and described herein. For example, those skilled in the art will understand and 
appreciate that a methodology could alternatively be represented as a series of 
interrelated states or events, such as in a state diagram. Moreover, not all illustrated acts 

30 may be required to implement a methodology in accordance with the present invention. 

8 
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At 200, the non-integrated tools are available for use, yet cannot be employed as 
integrated tools. At 204, an artifact provider API is employed with one of the tools to 
expose its artifacts for public use. At 206, an artifact consumer API is employed on 
another tool to expose its references associated with the artifacts. At 208, the references 
-5, are linked to the artifacts, making the tools integrated. The process then reaches a Stop 
block. 

Referring now to FIG. 3, there is illustrated a linking pattern 300 of a consumer 
and provider and, referring and referenced artifact associations. An artifact provider 302 
can create and reveal a number of different types of URIs (Uniform Resource Identifiers) 

10 for supporting at least the following entities: a loosely coupled server-based interaction, a 
loosely-coupled client, caching, and tightly-coupled interactions that support any artifact- 
specific functions by contract with callers. As illustrated, the provider 302 creates the 
URI of the referenced artifact that facilitates exposing artifact-specific data. An artifact 
consumer 304 holds a link to the referenced artifact, and URI to the referring artifact, that 

15 exposes the artifact-specific data. Along with the link, is the link type. The URI to the 
referenced artifact supports loosely coupled interactions and tightly coupled interactions, 
where the latter support any artifact-specific functions by contract with callers. A link 
306 is established from the consumer 304 to the provider 302 to expose the artifact data 
to the consumer 304. Note that use of a link is neither restricted to the structure 

20 represented by the disclosed URI nor a URI, generally, but can be of any type of linking 
mechanism. Referring now to FIG. 4, there is illustrated a user interface (UI) 400 that 
facilitates the presentation of artifact dependencies. The UI 400 can be used to display 
link type information 402 from a registered Link definition, artifact type information 404 
from a registered Artifact definition, artifact name information 406 from GetArtifact, and 

25 last-modified information 408 from GetArtifact. 

Principal elements of the present invention include the following. Persistent data 
includes artifact metadata, link instances, and artifact/link instance cache information. 
With respect to artifact metadata, in order to participate in the linking service, each 
artifact provider registers the artifact type for each artifact it provides and registers the 

30 link types each of those artifacts may host. With respect to link instances (generic artifact 
provider database), for tools in which it is difficult or inconvenient to store links natively, 
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the disclosed linking architecture includes a "generic artifact provider" implementation. 
The cache facilitates caching artifacts and their links to optimize query performance. 

Common formats and schemas include an artifact ID, a generic artifact schema 
(GAS), and generic artifact database schema (GADS). The artifact ID is an immutable 
5« and unique constructed key. It is exposed through services offered by an artifact provider 
and is materialized as a URI. The GAS is a common and abbreviated form in which any 
artifact, along with its outbound links, can be returned through a generic request. The 
GADS enables storage of artifacts and links presented in generic artifact schema form. It 
is used as the schema for both the generic artifact provider and the artifact/link cache. 

10 The architecture of the present invention also includes an API and conventions for 

a link-enabled artifact provider. This API is implemented by each tool or service that 
participates in integration. A GetArtifacts method returns 1 :m artifacts in generic artifact 
schema-format based on a string of artifact ID's. By convention, each GetArtifact 
implementation raises ArtifactChanged events to the Link Cache Manager (and other 

1 5 tools in the environment) returning generic artifact schema-conformant artifacts. A 

SynchronizeArtifactCache method reports artifacts and links to the cache asynchronously 
by raising events similar to ArtifactChanged. 

The architecture also includes an API for a link-enabled artifact consumer. This 
API must be implemented by each tool or service that participates in linking and holds 

20 links to other artifacts. A GetReferencedArtifacts method returns the list of artifacts that 
point to a supplied set of artifact IDs in generic artifact schema-format. 

Also provided is an API for a Link Manager. A GetArtifacts method returns a set 
of artifacts potentially from multiple providers in generic artifact schema-format. If the 
. Artifact/Link cache is enabled the answer is derived from it unless overridden, in which 

25 case the providers are individually queried and their responses aggregated. A 

GetReferencedArtifacts method returns the list of artifacts, potentially from multiple 
providers that point to a supplied set of artifact IDs in generic artifact schema-format. A 
SynchronizeArtifactCache method invokes each tool's SynchronizeArtifactCache method 
for full cache synchronization. 

30 The architecture provides an API for a generic artifact provider (GAP). All 

methods from the artifact provider API are implemented by the GAP. All methods from 

10 
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the artifact consumer API are implemented by the GAP. An UpdateArtifactData method 
pushes an artifact in generic artifact schema-format into the GAP database. A 
GetArtifactsByExternallD method enables query of the GAP database by an identifier 
that may not conform to an ArtifactID but is understood by the underlying tool. 
5* A re-hostable UI is provided for showing inter-artifact references. 

Well-Formed IS URIs 

An artifact's identifier consists of a well formed IS Uri. Each IS Uri is formed by 
the artifact's provider. While some elements that make up a well-formed Uri are derived 
10 from the IS environment, others are supplied by the tool itself. The following discussion 
identifies each element of the Uri and explains how its value is derived. 

Following is a sample of a well-formed IS Uri: 

http: //<ISNamespace>/vset/<tooltype>. <toolinstance>/ { <artif acttype>/ } <t 
15 ool-specific id> 

- http is a constant that appears because the Uri can appear outside of the IDE 
Integrated Development Environment). If it does, it will be handled according to the 
rules described hereinbelow under "External Addressability". 

20 - Each IS logical server defines a namespace. <ISNamespace> is the simply the 

name of the server; e.g., "Server22." 

- vset is a constant that enables IS Uri handlers to recognize the string as a IS 

Uri. 

- <tooltype> identifies the tool interface supported by the tool responsible for 
25 maintaining and answering questions about the artifact (i.e., the artifact provider.). This 

enables a calling tool (one holding a link) to make decisions about how to handle an 
artifact based on the interface offered by the tool. Example: vsbug, vsversionstore, etc. 
Tooltype identifies the API and is specified by the tool. 

- <toolinstance> describes the specific instance of the artifact provider 

30 responsible for the identified artifact. The combination <tooltype><toolinstance> are 
unique within a IS Namespace. For instance, Tooltype instance is assigned by IS at 
installation time and stored in the tool. 

11 
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- <artif actttype> (optional) is the type of artifact maintained by the tool. A 
tool will only supply an artifact type if the type is immutable (i.e., if the type of an 
instance cannot change over its lifetime.). Artifact types are registered by the tool at 
installation time. 

-5. - <tool-specif ic id> is an immutable reference to the artifact instance. Tool- 

specific id is created and maintained by the tool. 

Examples: 

Uri pointing to a file stored in H: http://Server08/vset/vsversionstore.2/flle^4e3216 
1 0 Uri pointing to requirement record in C: http://Server08/vset/vsbug. l/req/345 

Encode/Decode Artifact URI Utility Functions 

In order to encourage consistent formatting of URIs, the IS offers a pair of utility 
functions to encode and decode them based on a structure. 

15 

string EncodeUri (Artifact Id artifactld) 

EncodeUri takes a structure of type Artifactld and produces a string that conforms 
to the following URL rules. Non-null values for ArtifactlD.ToolInstance (in the form 

20 toolType.toolInstance) and ArtifactlD.ArtifactType are supplied by the caller. If 

ArtifactlD.ServerNamespace = null, then the name of the currently active namespace is 
used for the ISNamespace portion of the URI. In most cases, a tool supplies a non-null 
value for ArtifactlD.ToolSpecificID. If ArtifactlD.ToolSpecificID - null, then 
EncodeUri inserts the string "<?>" into tool-specific id. This string has special meaning 

25 when adding an artifact to the Generic Artifact Provider; otherwise, its use can be 
avoided. 

Artifactld DecodeUri (string artifactUri) 

30 DecodeUri takes a string that conforms to IS Uri rules and returns a structure of 

type Artifactld. 

12 
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Example: 

The code snippet below illustrates the building of an artifact Id and its conversion 
to a well formed IS Uri using the EncodeUri method. The resulting URI is: 

5 http://IS00 1 /vset/Work%20Item%20%Tracking. 1 /defect/529 1 

DecodeUri works in reverse. 

public void EncodeUriExample ( ) 

io { 

ISServerProxy IS = new ISServerProxy () ; 

Artifactld artld = new Artifact Id () ; 
art Id . ServerNamespace = null; 
15 artld. Toollnstance = "Workltems . 1 " ; 

artld. ArtifactType = "defect"; 
artld. ToolSpecificId = "5291"; 



20 } 



string Uri = IS . EncodeUri (artld) ; 



Loose Coupling vs. Tight Coupling 

In the IS linking environment, tools use links to enable loosely-coupled behaviors. 
They can also provide specialized interfaces and interactions that provide a higher-level 
25 of specialized integration through tightly-coupled behaviors. Each is valid in the proper 
context. 

Loose coupling offers the following advantages. It is simple to add new artifact 
types into a web of artifacts without disturbing pre-existing applications. This is 
especially useful for third party integration. It is possible to aggregate results to provide a 

30 complete "where-used" picture for artifacts of varying types. Artifact handlers (providers 
and consumers) can change behaviors drastically and, as long as they continue to use the 
generic linking interfaces, all loosely-coupled behaviors will continue to work. 

Tools that offer tightly-coupled behaviors exploit links that conform to the linking 
service but they don't make use of generic linking interfaces. Instead, an artifact 

35 consumer takes advantage of specific interfaces offered by the artifact provider. These 
behaviors can be used to provide cross-tool behavior that is very specific to the 
participating tools. 
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Loose coupling can be used when a pointer to a referenced artifact can be present 
in a referring artifact unknown to the referenced artifact's provider. 

Example - A third party test case management tool is introduced into the suite. It 
is IS-enabled and thus provides a mechanism to build links to defects, for example. The 
defect does not need to know about this new type of referring artifact to show return 
information about it in an inversion query. 

Loose coupling can also be used when a referring artifact can point to a 
referenced artifact type it does not know about, and also when the behaviors available for 
a referenced artifact are not influenced by the referring artifact. 

Example - Inside an IDE when a user wants to see what work items are associated 
with a build, the list of work items is returned in the build's inversion query UI. 
Likewise, when a user wants to see what work items were affected by a specific change 
set, a list of work items is returned in the change set's inversion query UI. In either case, 
the user should be able to double-click any of the work items and a document window for 
that window will be displayed. The desired behavior is the same whether the referring 
artifact is a build or a change set; thus, the behavior is not influenced (in these two cases) 
by the referring artifact. 

Loosely-coupled interactions are enabled through artifact providers and 
consumers (a) following IS conventions and (b) implementing standard interfaces. 

How Tools Participate in Linking 

Each tool that offers artifacts is an artifact provider. An artifact provider registers 
its artifact types and implements a set of interfaces that enable a loosely-coupled tool to 
read those artifacts. Artifact provider responsibilities are detailed under "Artifact 
Provider Obligations". 

An artifact provider that also contains links to other artifacts is an artifact 
consumer. An artifact consumer has some additional obligations beyond those of a 
provider. It registers link types and offers standard methods to answer queries and 
inversion queries. Artifact consumer responsibilities are detailed under "Artifact 
Consumer Obligations. 
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Finally, IS itself provides a number of facilities for registration, discoverability, 
and cross-service link query, which are detailed under "IS APIs". 

• 

Artifact Provider Obligations 
5 Any tool that hosts artifacts is an artifact provider. An artifact provider has the 

following responsibilities, where some are optional, and others are mandatory. At 
registration time, each artifact provider registers each artifact type it hosts with IS, 
registers any events it can raise (including artifact change events), registers the URL of 
its provider web service interface, offers a web service interface that can return the IS Uri 

10 for each artifact it owns, offers a GetArtifacts method that can be used to retrieve 

instances of each artifact type it owns, can include an artifact's Uri as a return value in 
each method that returns an artifact instance, raises an event when an artifact it owns is 
created, deleted, or changed in a way that causes a GetArtifacts method execution for that 
artifact to return a different result, offers a way to handle external addressability for each 

15 artifact type it provides, and can implement a client API that responds to in-the-IDE 
requests for artifacts it owns (ExecuteDefaultAction, GetAllowableActions, 
ExecuteAction). IS and others can use it to provide uncoupled access between an artifact 
consumer and provider. 

20 Artifact Type Registration 

Registration of Artifact Types and Link Types takes place at installation time. 
Each tool prepares an XML (extensible Markup Language) document that conforms to 
the IS Registration Service XML Schema. The following information is required for 
each artifact type: Provider responsible for artifacts of this type; Artifact type name (not 

25 localizable); and Artifact type label (localizable). The following information is required 
for each link type: Artifact type name of referring artifact; Link type name (not 
localizable); Link type label (localizable); Inverse link type label (localizable); and 
optional referenced artifact types array. With regard to the Link type label, forward and 
inverse is used to provide readings in either direction, e.g., man bites dog, dog is bitten by 

30 man. If the referenced artifact types array is empty, the referenced end of the link is 
untyped. That is, links of this type may point to any artifact. Each element in the 

15 
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referenced artifact types array indicates both the referenced artifact type's service and the 
referenced artifact type's name. 

Provider Server API - IToolServerLinking 

An artifact provider offers the GetArtifacts method to retrieve instances of each 
artifact type it owns. The GetArtifacts method takes an array of Uris as input. The return 
value is an array of objects that conforms to the Generic Artifact Display Schema (GAS). 

Artifact [] GetArtifacts (string[] Artif actUriList ) 

GetArtifacts can take an array of artifact Ids in the form of a IS Uri. The provider 
is responsible for returning an artifact instance for each artifact Id represented in GAS 
format. 

Example: 

Given the following: an IS Namespace named "IS001", and a defect tracking tool 
registered to IS001 named "Workltems. 1"; and two work items: Defect 152, and 
Requirement 153. 

Finally, imagine an array named ArtifactUri[] with these two elements: 
http ://IS00 1 /vset/Workltems. 1 /Defect/ 1 52 and http://IS00 1 /vset/Workltems. 1 /Req/ 1 53 
The value of MyArtifacts after this call: 

Artifact [] MyArtifacts = workltemTool . GetArtifacts (Artif actUri [] ) 

will look similar to the following XML document herein once it has been 
serialized. 

<?xml version="l . 0" encoding="utf-8" ?> 
<Artif acts 

xmlns="http : //www . company . com/Tool/GenericArtif actSchema . xsd"> 
<Artifact> 

<Uri>http: //ISOOl/vset/Workltems . 1/Def ect/152</Uri> 
<ProviderName>MS Work Item Tracking</ProviderName> 
<Title>152 (Open) </Title> 
<Type>Defect</Type> 

<LastChangedOn>2003-10-24T20 : 4 7 : 58 . 170</LastChangedOn> 
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<LastChangedBy>dn\inium</LastChangedBy> 
<ExtendedAttributes> 

<ExtendedAttribute> 

<Name>Status</Name> 
5 <Value>Open</Value> 
</ExtendedAttribute> 
<ExtendedAttribute> 

<Name>Assigned To</Name> 
<Value>Allen Clark (allclark) </Value> 
10 </ExtendedAttribute> 
</ExtendedAttributes> 
<Links> 

<Link> 

<LinkType>depends on</LinkType> 

15 

<ReferencedUri>http: //ISOOl/vset /Workltems . 1/Def ect/173</Ref erencedUri> 
</Link> 
<Link> 

<LinkType>f ound in</LinkType> 

20 

<ReferencedUri>http: //ISOOl/vset /Builds. 1 /Build/2003, 11. 15</ReferencedU 
ri> 

</Link> 
<Link> 

25 <LinkType>checked in</LinkType> 

<ReferencedUri>http: //ISOOl/vset /Hat . l/ChangeSet/987Urt5B</Ref erencedUr 
i> 

</Link> 
30 </Links> 
</Artifact> 

<Artifact> 

<Uri>http: //ISOOl/vset /WorkI terns. 1/Req/153</Uri> 
35 <ProviderName>Work Item Tracking</ProviderName> 

<Title>153 (In Work) </Title> 
<Type>Requirement</Type> 

<LastChangedOn>2003-10-27T20: 36: 52. 170</LastChangedOn> 
<LastChangedBy>eeykholt</LastChangedBy> 
40 <ExtendedAttributes> 

<ExtendedAttribute> 

<Name>Status</Name> 
<Value>In Work</Value> 
</ExtendedAttribute> 
45 <ExtendedAttribute> 

<Name>Assigned To</Name> 
<Value>Ra j Selvara j (naselvar ) </Value> 
</ExtendedAttribute> 
</ExtendedAttributes> 
50 <Links> 

<Link> 

. <LinkType>authored in</LinkType> 

<ReferencedUri>http: //ISOOl/vset /Teamhare/ReqDoc/38 97 6FBA</Ref erencedUr 
55 i> 

</Link> 
<Link> 
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<LinkType>depends on</LinkType> 

<Ref erencedUri>http: //ISOOl/vset/Workltems . 1 /Defect / 173</ReferencedUri> 
</Link> 
•5 </Links> 
</Artifact> 
</Artifacts> 

SynchronizeArtifactCache Method 
1 0 The SynchronizeArtifactCache method is used to reconstruct an artifact cache if it 

has been damaged. 

void SynchronizeArtif actCache ( ) 

1 5 The SynchronizeArtifactCache method is invoked by IS to initiate notification of 

the full set of forward links held by an artifact consumer. The artifact consumer must 
raise a CacheArtifact event for each of its artifacts (multiple artifacts can be packaged 
into a single event). IS listens for these events and uses the result to populate to populate 
a link cache that can be used to resolve simple queries without invoking the consumer's 

20 GetArtifacts or GetReferencingArtifacts methods. 

void SynchronizeArtif actCache (DateTime from, DateTime to) 

SynchronizeArtifactCache can be constrained by a date range. In this case, the 
25 artifact consumer is only obliged to issue CacheArtifact events for artifacts modified 
between from and to, inclusive. 

For each artifact held by the artifact provider, the SynchronizeArtifactCache 
method packages the artifact and its outbound links, if any, as an XML document 
(conformant with the GAS schema). Note that this formatting requires exactly the same 
30 logic as that used by GetArtifacts. The method also raises the CacheArtifact event 
passing the GAS-conformant XML document to IS. 

When the provider has completed its caching activity, it issues an EndCacheLoad 
event. Note that a GAS document can hold multiple artifacts. Thus, the provider has the 
option of passing several artifacts to the cache in one fell swoop. IS normally updates its 
35 cache by responding to ArtifactChanged events - the same ArtifactChanged events to 

18 



MS307207.01 



which other tools subscribe. However, IS also listens to CacheArtifact events, to which 
other tools and services do not subscribe. 

Provider Client API - IToolClientLinking 

'5- The artifact provider client API exists to deal with loosely-coupled interactions 

inside the IDE. For instance, imagine the scenario in which a tool displays a list of 
artifacts whose Ids are in the Links collection returned as a result of a GetArtifacts call. 
A user wants to display one of the (arbitrary) artifacts. If the artifact's provider 
implements the ExecuteDefaultAction method described herein, the holder of the list can 

10 invoke the action (most likely a navigation action to display the artifact) without any 
knowledge of the artifact or the artifact's type. 

ExecuteDefaultAction Method 

This method can be provided by an artifact provider as part of its provider client. 
15 It is installed as part of the provider's client installation and can be discoverable. 

bool ExecuteDefaultAction (string artif actUri) 

ExecuteDefaultAction takes a single artifact URI as input. The provider client is 
20 responsible for executing whatever default behavior is appropriate for the artifact. It 

returns true if the execution of the default action was successful. ExecuteDefaultAction 
is not normally invoked directly. Instead, it is invoked through the IS client's 
ExecuteDefaultAction method. 

25 ArtifactChanged Event 

When an artifact is created, deleted, or changed in a way that causes a 
GetArtifacts method execution for that artifact to return a different result, the artifact 
provider must raise the ArtifactChanged event. 

When an artifact changes, the provider raises an async ArtifactChanged event to 
30 IS Eventing using the FireAsyncEvent method. The ArtifactChanged event type is 

automatically installed as part of IS during registration. It includes an XML document 
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that conforms to the GAS schema. Since GAS includes an artifact's forward links, 
ArtifactChanged is used to inform listeners of link changes as well as other artifact 
changes. 

The ArtifactChanged event is to be raised whenever an artifact is added, changed 
-5. or deleted. The GAS schema includes an attribute on the Artifact element that enables a 
caller to indicate whether the artifact it contains was added, changed or deleted. The 
following illustrates two changes reported in a single ArtifactChanged event: Defect 152 
has been added and Requirement 153 has been deleted. 

10 <?xml version= M l . 0" encoding= ,, utf-8" ?> 
<Artif acts 

xmlns="http: //www . company . com/Tool/GenericArtif actSchema .xsd"> 
<Artifact ChangeType="Add"> 

<Uri>http: //ISOOl/vset/Workltems . 1/Def ect /152</Uri> 
15 <ProviderName>MS Work Item Tracking</ProviderName> 

<Title>152 (Resolved) </Title> 
<Type>Defect</Type> 

<LastChangedOn>2003-10-24T20 : 47 : 58 . 170</LastChangedOn> 
<LastChangedBy>dminium</LastChangedBy> 
20 <ExtendedAttributes> 

<ExtendedAttribute> 

<Name>Status</Name> 
<Value>Resolved</Value> 
</ExtendedAttribute> 
25 <ExtendedAttribute> 

<Name>Assigned To</Name> 
<Value>Peanuts McFadden (nuts ) </Value> 
</ExtendedAttribute> 
</ExtendedAttributes> 
30 <Links> 

<Link> 

<LinkType>depends on</LinkType> 

<ReferencedUri>http: //IS001/vset/Wor kit ems. 1/Def ect/ 173</ReferencedUri> 
35 </Link> 
<Link> 

<LinkType>f ound in</LinkType> 

<Ref erencedUri>http: //ISOOl/vset /Builds . l/Build/2003 . 11 . 15</Ref erencedU 
40 ri> 

</Link> 
<Link> 

<LinkType>checked in</LinkType> 

45 <ReferencedUri>http: //IS001/vset/Hatteras . 1/ChangeSet /987Urt5B</Ref eren 
cedUri> 

</Link> 
</Links> 
</Artifact> 



50 
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<Artifact ChangeType= r, Delete"> 

<Uri>http: //ISOOl/vset/Wor kl terns. 1 /Defect /23</Uri> 
</Artifact> 
</Artifacts> 

.5 

Any tool can register to the generic ArtifactChanged event. In addition, the 
Artifact/Link Cache listens for these events and uses them to update itself. 

External Addressability 

10 An artifact provider offers a way to handle external addressability for each artifact 

it provides. Imagine that a user puts the URI for a IS artifact into a piece of email. The 
recipient of the email will be able to do nothing with the URI unless it is externally 
addressable. If it is, the browser can figure out what to do with it. 

1 5 Example: 

For instance, imagine that the source file stored in the version store at this 
location: 

\WSServer8\FinProi\Acctg\WebUI\taccts.cs 

20 . . .is represented by this URI: 

http:/A^SServer8/vset/vsversionstore.2/file/b4e32 1 6 

Now consider that an email is sent to a user that indicates thata tacct program just 
failed (where "tacct" is a hyperlink behind which is the IS Uri). When the user selects 

25 the hyperlink, he rightly expects that some representation of the thing associated with the 
URI will be produced. In this case, maybe it is some metadata and descriptive 
information about the file (to help jog his memory). This is possible because each artifact 
provider can make those artifacts externally addressable. It does so by providing, at 
installation time, an page that can handle artifacts of types it manages. This page is 

30 stored in a well-known virtual directory on the IS server and is named for its tool 

instance. The page can be very simple, invoking a simple XSL transform to produce a 
read-only page. Alternatively, it can be very complex providing the gateway into a full- 
blown application. 
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The IS provides an ISAPI (Internet Server Application Program Interface) filter 
that converts the URI into a URL for directing to the proper directory and enables the 
page to handle the artifact type and moniker as ordinary parameters. 

Example: 

This incoming Uri: http://Server8/vset/vsversionstore.2/file/b4e3216 is converted to 
something like this by the ISAPI filter: 

http://Server8/vsversionstore.2.aspx?artifactType=file&id=b4e3216 
. . .where "artasp" is the folder on Server8 where the ASP page is stored. 

Artifact Consumer Obligations 

At registration time, each artifact consumer registers each link type it hosts with 
IS, registers the URL of its consumer web service interface, subscribes to any events to 
which it can respond (including artifact change events), offers GetReferencingArtifacts 
methods that can respond to "do you point to me?" queries, and can respond to 
ArtifactChanged events; for deletes the referring artifact link should be deleted. For 
changes, the referring artifact can check for a situation that might cause the link to be 
invalidated. 

Consumer Server API 

An artifact consumer must offer GetReferencingArtifacts methods that can 
respond to "do you point to me?" queries. The GetReferencingArtifacts takes an array of 
URIs as input. The return value is an array of Artifact objects that conform to the 
Generic Artifact Database Schema (GAS). Following are the method signatures: 

Artifact [ ] GetReferencingArtifacts (string [ ] artif actUriList ) 

This version of GetReferencingArtifacts takes an array of referenced artifact Ids. 
The consumer is responsible for returning the list of all referring artifacts it owns that 
point to any of the included referenced artifacts as GAS-compliant Artifact objects. 
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Artifact [ ] Get Re f erencingArtif acts (string [ ] art if actUriList , 
LinkFilter [] linkFilterList ) 

This version of GetReferencingArtifacts takes an array of referenced artifact Ids 
.5 and an array of link filters. Link filters can be used to restrict the returned artifacts by 
tool type offering the artifact, artifact type, or link type. 

ArtifactChanged Event Handler 

As described herein, each time an artifact materially changes the artifact provider 
10 raises the ArtifactChanged event. Each artifact consumer can listen for these 
ArtifactChanged events by registering an ArtifactChanged event handler. 

Each consumer's ArtifactChanged event handler inspects the event to determine 
whether it holds artifacts of interest. If it does, the consumer's event handler can then 
respond to the change. Normally such a response takes one of the following forms: 
1 5 - If the consumer only holds a pointer to the artifact, it is frequently only 

interested in ArtifactChanged in the case of a delete. The consumer removes any links to 
the deleted artifact. 

- In some cases there may be specific policy information that requires that the 
referenced artifact be in a specific state for the referring artifact to hold a link to it. If so, 
20 the consumer can ensure that after the change the referenced artifact is still in the correct 
state; otherwise, the consumer removes its links. 

The Artifact/Link Cache uses the ArtifactChanged event to stay up-to-date. 

IS APIs 

25 The following APIs are offered directly by various elements in IS. 

Server API - EncodeUri/DecodeUri utility methods 

GetArtifacts Method 

30 The GetArtifacts method takes an array of URIs as input. The return value is an 

object that conforms to the GAS. From a logical standpoint, the IS version of 
GetArtifacts invokes the GetArtifacts methods of each artifact provider for which an 
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artifact is requested. Physically, the query is executed against the Artifact/Link Cache 
unless the direct parameter = true. The method signature appears below. 

• ( 

Artifact[] GetArtifacts (stringU artif actUriList ) 

5. 

GetArtifacts takes an array of artifact Ids in the form of a ISUri. The provider is 
responsible for returning an artifact instance for each artifact Id represented in GAS 
format. This version of GetArtifacts runs against the IS Artifact/Link Cache. 

10 Artifact [] GetArtifacts (string [] artif actUriList , bool direct) 

This version of GetArtifacts behaves exactly as the form above, except that the 
caller can provide a value for the direct parameter. When direct = true, the result set is 
built from calling individual providers GetArtifacts methods directly instead of exploiting 
1 5 the Artifact/Link Cache. This provides up-to-date data at the cost of an expensive 
aggregate query. 

GetReferencingArtifacts Method 

The IS Cross-Service Inversion Query, GetReferencingArtifacts, runs as query 
20 aggregators of sorts. From a logical standpoint a cross service inversion query requested 
from IS runs link inversion queries against all IS-enabled tools that might be able to 
contribute information to a query, aggregates the results from all respondents, and sends a 
single result set (in the form of an XML document) back to the user. From a physical 
standpoint, a IS Cross-Service inversion query can actually be executed against the IS 
25 Artifact/Link Cache. 

Artifact [ ] GetReferencingArtifacts (string [ ] artif actUriList ) 

This version of GetReferencingArtifacts takes an array of referenced artifact Ids. 
30 Each potential artifact consumer (based on registration information) is consulted to build 
a full list of artifacts. Each consumer is responsible for returning the list of all referring 
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artifacts it owns that point to any of the included referenced artifacts as GAS-compliant 
Artifact objects. IS then merges the lists and returns a single Artifact array to the client. 

Artifact [ ] GetRef erencingArti f act s (string [ ] art if act Uri List , 
LinkFilter [ ] linkFilterList ) 

This version of GetReferencingArtifacts is the same as the previous except that it 
takes an additional array of link filters. Link filters can be used to restrict the returned 
artifacts by tool type offering the artifact, artifact type, or link type. 

Artifact [] GetReferencingArtifacts (string [] artifactUri, bool 
direct) 

This version of GetReferencingArtifacts behaves exactly as the first form except 
that the caller can provide a value for the direct parameter. When direct == true, the 
result set is built from calling individual providers' GetReferencingArtifacts methods 
directly instead of exploiting the Artifact/Link Cache. This provides up-to-date data at 
the cost of an expensive aggregate query. 

Artifact [ ] GetReferencingArtifacts (string [ ] artif actUriList , 
bool direct, LinkFilter[] linkFilterList) 

This version of GetReferencingArtifacts behaves exactly as the second form 
except that the caller can provide a value for the direct parameter. When direct = true, 
the result set is built from calling individual providers GetReferencingArtifacts methods 
directly instead of exploiting the Artifact/Link Cache. This provides up-to-date data at 
the cost of an expensive aggregate query. 

Link Helper Methods - ILinking 

The IS Link Helper methods post-process an array of Artifact objects in which 
outbound (referring) links are nested inside each artifact to produce a flat list of links that 
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conforms to the GLS. ExtractLinks returns a flat list of all links found inside an Artifact 
object array subject to conformance to the optional user-supplied filter. 

The third form of ExtractLinks does the same, but only for links whose 
Referenced Id is passed in through a string array. In that way, ExtractLinks can be paired 
with GetReferencingArti facts to create a flat, filtered list of only those links pointing to 
the artifact Ids of interest. 

Link [ ] ExtractLinks (Artifact [ ] art if act List ) 

Given an Artifact object array in which each link is packaged with its referring 
artifact, ExtractLinks produces a flat list of links inside a Link array that conforms to the 
GLS. 

Link[] ExtractLinks (Artifact [] artif actList , LinkFilter [] 
linkFilterList ) 

In this form of ExtractLinks, a link is only included if it conforms to the filters in 
linkFilterList. 

Link [ ] ExtractLinks (Artifact [ ] artif actList , LinkFilter [ ] 
linkFilterList, string [] artif actUriList ) 

In this form, only those links whose Referenced URI is included in the ArtifactUri 
string array are returned. LinkFilterList may be null, if no link type filtering is required. 
ExtractLinks Example 1 : Produce a flat list of links 

Get the artifacts that result in the Artifact array. Then extract a flat list of links 
from that Artifact object array. 

ISServerProxy IS = new ISServerProxy () ; 

string [] artif actUris = new string [] 

{ "http: //ISOOl/vset/workitems . 1/def ect/152", "http : //ISOOl/vset/Workltem 
s.l/Req/153"}; 
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Artifact!] artifacts = IS . GetArtif acts (artif actUris ) ; 
Link[] links - IS . ExtractLinks (artif acts ) ; 



The links object returned from ExtractLinks corresponds to the XML schema 

5" below. 



<?xml version="l . 0" encoding="utf-8" ?> 

<Links xmlns="http: //tempuri . org/ISGenericLinkSchema . xsd"> 
<Link> 

10 

<Ref err ingUri>http: //I SOOl/vset/WorkI terns. 1 /Defect /152</ReferringUri> 

<LinkType>depends on</LinkType> 
<ReferencedUri>http: //IS001/vset/Wor kit ems. 1 /Defect/ 17 3</ReferencedUri> 
</Link> 
15 <Link> 

<ReferringUri>http: //ISOOl/vset /Workl terns . 1 /Defect /152</Ref erringUri> 

<LinkType>f ound in</LinkType> 
<ReferencedUri>http: //ISOOl/vset /Builds . 1 /Build/2003 . 11 . 15</Ref erencedU 
ri> 

20 </Link> 
<Link> 

<ReferringUri>http: //ISOOl/vset /Workl terns. 1 /Defect /152</ReferringUri> 
<LinkType>checked in</LinkType> 
<Ref erencedUri>http: //IS001 /vset /Hatteras . 1 /ChangeSet /987Urt5B</R 
25 ef erencedUri> 

</Link> 
<Link> 

<ReferringUri>http: //ISOOl/vset /Workl terns. l/Req/153</ReferringUri> 
<LinkType>authored in</LinkType> 
30 <ReferencedUri>http: //ISOOl/vset /eLeadSharePoint /ReqDoc/38 97 6FBA< 

/Ref erencedUri> 

</Link> 
<Link> 

<ReferringUri>http: //ISOOl/vset/Workltems. l/Req/153</ReferringUri> 
35 <LinkType>depends on</LinkType> 

<ReferencedUri>http: //ISOOl/vset /Workltems . 1/Def ect /173</Ref erencedUri> 
</Link> 
</Links> 

40 

ExtractLinks Example 2: Produce a list of links that point to a particular defect. 
Assume that Defect 1 73 is only referenced from Defect 1 52 and Requirement 
153. In that case, GetReferringArtifacts for Defect 173 will return exactly the same 
Artifact array. In this example, ExtractLinks is used to return only the links that actually 
45 point back to Defect 1 73. 



ISServerProxy IS = new ISServerProxy () ; 
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stringf] artif actUris = new string [1] 
{ "http://IS001/vset/workitems. 1 /defect/ 173" } ; 

Artifact!] artifacts = IS . GetRef erencingArt if act s (arti f actUris ) ; 

*5. Link[] links = IS . ExtractLinks (artif acts, null, art if actUris ) ; 

The links object returned from ExtractLinks (now filtered by the 
same set of artifactUris as GetRef erencingArtif acts) is shown in Figure 
. m 5. 

10 <?xml version="l . 0" encoding="ut f -8 " ?> 

<Links xmlns="http: //tempuri . org/ISGenericLinkSchema . xsd"> 
<Link> 



<ReferringUri>http: //ISOOl/vset/WorkI terns. 1/Def ect /152</Ref erringUri> 
15 <LinkType>depends on</LinkType> 

<Ref erencedUri>http: //ISOOl/vset /Workltems . 1 /Defect /173</Ref erenc 

edUri> 

</Link> 
<Link> 

20 

<ReferringUri>http: //ISOOl/vset /Workltems. l/Req/153</ReferringUri> 
<LinkType>depends on</LinkType> 
<Ref erencedUri>http: //ISOOl/vset/Workltems . 1 /Defect /173</Ref erenc 

edUri> 
25 </Link> 
</Links> 



SynchronizeArtifactCache 

This method is invoked to cause a background update to the Artifact/Link Cache. 

30 

void SynchronizeArtif actCache ( ) 



The SynchronizeArtifactCache method causes IS to synchronize the artifact cache 
by invoking each artifact provider SynchronizeArtifactCache method. 

35 

void SynchronizeArtifactCache (DateTime from, DateTime to) 



SynchronizeArtifactCache can be constrained by a date range. In this case, each 
artifact consumer is only obliged to issue CacheArtifact events for artifacts modified 
40 between from and to, inclusive. 

Client API - IClientLinking 

The IS client API with regard to linking is made up of a single method. The 
function of this method is to invoke a tool's default action to display an artifact. 
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ExecuteDefaultAction 

bool ExecuteDefaultAction (string artifactUri) 

•5. 

ExecuteDefaultAction takes a single artifact Id as input. The client determines 
what action to execute based on the artifact's type and the registered mechanisms for 
handling default actions as follows. If the artifact type is associated with a registered 
provider client, the provider client's ExecuteDefaultAction is invoked. Otherwise, the 
10 Artifactld is handed to the IS Server for resolution using the external addressability 
mechanism. If successful, this results in a page being opened inside the IDE. If 
unsuccessful, the user will see an http 404 error. 



The Generic Artifact Provider 

1 5 Referring now to FIG. 5, there is illustrated a block diagram of one 

implementation of a GAP API in accordance with the present invention. The GAP is 
essentially a database application that offers the standard artifact provider and consumer 
methods. There is provided one or more IS-enabled tools 500 and a non-IS enabled tool 
502 some contents of which are desired to be accessed as an integrated tool. To facilitate 

20 interaction with the IS-enabled tools 500, the GAP 504 is employed that has associated 
therewith a GAP database 506. The GAP database 506 is structured in the format of the 
generic artifact database schema (GADS) described hereinbelow with respect to FIG. 7. 
In order to interact with the non-IS enabled tool, it is possible to write a GAP adapter 508 
so that, with minimal disruption to the original tool 502, tool data can be exposed as IS 

25 artifacts and hold links to IS artifacts. 

The GAP is specifically intended to address a situation in which it is impossible 
or inconvenient to satisfy artifact provider/consumer obligations directly in the tool that 
holds the artifact. For instance, a team wishes to link to and from documents stored in 
share server as though they were full-fledged artifacts. Sadly, the share server does not 

30 implement the IS-enablement APIs, and thus, does not offer IS-compliant URIs for its 
artifacts or offer the required methods (e.g., GetArtifacts/GetReferencingArtifacts.) 
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Using the GAP, the team can construct an "artifact proxy" for a share document. This 
proxy can be referenced by other artifacts and is capable of holding links to other 
artifacts, all on behalf of the real share document it represents. 

GAP is also intended to address a situation in which an artifact container is held 
'5- as a file, either in source code or in the file system. In this case, the tool responsible for 
creating the artifact has no say in its persistence and thus cannot insist that source control 
and the file system recognize and store links from the artifact. For instance, one tool 
wishes to hold links between a model and the source code generated from the model, 
where a model is stored as source code. Using the GAP, the tool can build an artifact 
1 0 proxy to hold those links. Further, additional artifact proxies can be built to represent 
artifacts internal to a file, such as a method in a source file or an XML Web Service in a 
tool model. 

Referring now to FIG. 6, there is illustrated a flow chart of one implementation 
for preparing a non-integrated tool for using the GAP. At 600, one or more non- 

1 5 integrated tools are received. At 602, the one or more non-integrated tools are prepared 
at registration time for exposing artifacts and references using the GAP in accordance 
with the present invention. At 604, a tool type is registered to act as an artifact provider 
for each GAP-managed artifact that maps to a GAP service. For a provider that includes 
both self-managed and GAP-managed artifacts, the tool type for each must be distinct. 

20 At 606, for each GAP-managed artifact, its artifact type and outbound link types are 
defined, if any. The process then reaches a Stop block. 

Referring now to FIG. 7, there is illustrated a generic artifact database schema 
(GADS) 700 used both for the GAP and a cache. The GADS 700 includes an Artifact 
element 702 that contains exactly one displayable artifact, which consists of the 

25 following sub-elements: a URI of the returned artifact; an artifact Title, which is the 
localized friendly name of the returned artifact 's types; date and time of last change 
(LastChangedOn), if available; userld of last person to change this artifact 
(LastChangedBy), if available; ExternallD, which element is reserved for use by the IS 
generic artifact provider, and contains information that enables IS and its agents to access 

30 an item that has no direct artifact provider; and an optional bit attribute SyncFlag used in 
the cache and holds the instance-specific synchronization state. 
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The GADS 700 also includes a Link sub-element 704 of the Artifact element 702 
that contains the following: a referring link URI (ReferringURI), link type (LinkType), 
and referenced link URI (ReferencedURI). An Extended Attributes sub-element 706 of 
the Artifact element 702 contains a collection of name/value pairs that describe optional 

"5- artifact-specific properties the provider can offer. 

Referring now to FIG. 8, there is illustrated a flow chart of one method of 
implementing the GAP in accordance with the present invention. At 800, a provider 
registers artifact type information for each artifact exposed. At 802, a provider registers 
links types for each artifact it hosts. At 804, it is determined whether the registration 

10 information can be stored locally or natively. If not, flow is to 806, the GAP is 

employed. At 808, the data is processed against the GAP database. At 8 1 0, the non- 
integrated tool can now interface to IS-enabled tools. The process then reaches a Stop 
block. If, however, the registration information can be stored natively, flow is from 804 
to 8 1 2 to process without the GAP. Flow is then to the Stop block. 

1 5 Referring now to FIG. 9, there is illustrated a flow chart of one method of 

implementing a GAP adapter in accordance with the present invention. When artifacts 
are modified, there is one record in the GAP database for each artifact. In order to 
construct an adapter, it must be possible to detect changes in the artifact data stored in the 
underlying tool. 

20 At 900, an item is added to be represented as an artifact to a tool. At 902, a URI 

is created for the artifact. When an item to be represented as an artifact is added to the 
tool, the tool adapter creates a corresponding artifact record in the GAP by using the GAP 
UpdateArtifactData method, as indicated at 904. This record maps this artifact URI to 
the identifier that is known to the tool (called its External Id). For instance, the external 

25 Id for a document stored in a file share can be its folder hierarchy and file name. 

The artifact record conforms to the GAS, in that it includes, for example, the 
artifacts URI, title, external Id and extended attributes. At 906, the system operates to 
detect modifications in artifact data of the tool. At 908, the system determines if a 
modification has occurred. If No, flow is back to 906 to continues monitoring for 

30 modifications. If Yes, flow is to 910 where, for an item "change", the tool adapter posts 
the modification by using the GAP UpdateArtifactData method. Note that it is important 
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to distinguish between a change and a delete/add to maintain the integrity of links to and 
from GAP artifacts. At 912, if the modification is an "add/delete", the adapter 
adds/deletes the corresponding record to/from the GAP database. When an item related 
to an artifact is deleted, the tool adapter deletes the corresponding record from the GAP 
S m by using the GAP UpdateArti fact Data method. When a link from an artifact is to be 
created or modified, the UpdateArtifactData method is used. At 914, link creations and 
modifications are process. The process then reaches a Stop block. To handle external 
addressability, an artifact handler is defined and registered. 

10 GAP API 

Because it is both an artifact provider and an artifact consumer, the GAP API 
offers each of the standard server provider and consumer methods and behaviors (that is, 
all methods in the IToolServerLinking Interface. In addition, it offers the following 
methods to enable maintenance of the artifact data it holds. 

15 

bool UpdateArtifactData (Artifact [] artifacts) 

A caller populates an Artifact array object and invokes UpdateArtifactData to 
update the GAP database. The Artifact array includes the entire artifact description as 
20 held in the GAP database, including extended attributes and links. Each artifact must 
have a valid value for its ChangeType attribute (add, change, delete). 

On add: If the <tool-specific id> for an artifact's Uri is set to the special value 
"<?>", GAP generates a unique ID and replaces the associated Uri in its Artifact.Uri 
property. Otherwise, the value of <tool-specific id> is used directly. An error is raised 
25 on an attempt to add an artifact when a record keyed by the incoming Artifact.Uri value 
is already present in the GAP. 

On change or delete, a record keyed by the incoming Artifact.Uri value must exist 
in the database, otherwise an error is raised. 

30 Artifact [ ] GetArtif actsByExternalld (string [ ] externalld) 
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This method is used to return GAS-compliant Artifacts based on the external Ids 
to which a GAP artifact's URI is matched. Note that the Artifact array includes both URI 
and external Id, so the standard GetArtifacts method is used to determine the external Id 
given a URI; this method enables a URI to be determined given an external Id. 
'5- Referring now to FIG. 10, there is illustrated a system 1000 that facilitates 

accessing non-integrated tools in accordance with the present invention. The system 
1000 illustrates the use of several non-integrated tools, a first tool 1002, a second tool 
1004, and a third tool 1006. The first tool 1002 requires implementation of the GAP 
1008 to be enabled as an artifact provider to an IS-enabled tool 1010. In support thereof, 

10 a tool-specific adapter 1012 is created that facilitates exposing one or more artifacts to the 
enabled tool 1010. Links and references can be stored in the GAP database 506 
according to GADS. 

The second tool 1004 integrates a provider enablement API 1014 on top of a 
native interface that exposes it artifacts publicly. The third tool 1006 integrates a 

1 5 consumer enablement API 1 01 6 on top of a native interface that exposes references to the 
provider artifacts of the second tool 1004 and artifacts of the first tool 1002. 

The system 1000 further includes an artifact/link cache 1018 that caches artifact 
and link information in accordance with the present invention. A linking manager 1020 
manages the cache 1018. The cache 1018 interfaces at least with the first, second and 

20 third tools (1002, 1004, and 1006) to facilitate caching at least the artifact and link 
information, and other information described herein. 

The subject invention (e.g., in connection with selection) can employ various 
artificial intelligence based schemes in the form of, e.g., a classifier 1022 (optional), for 
carrying out various automatic processes of the subject invention. The implementations 

25 described herein have generally dealt only with one hop, that is, a tool interfacing directly 
with another tool. The classifier 1022 can be used to facilitate a more sophisticated query 
a link description can be derived that extends beyond one hop. 

A classifier is a function that maps an input attribute vector, x = (xl , x2, x3, x4, 
xn), to a confidence that the input belongs to a class, that is, f(x) = confidence(class). 

30 Such classification can employ a probabilistic and/or statistical-based analysis (e.g., 
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factoring into the analysis utilities and costs) to prognose or infer an action that a user 
desires to be automatically performed. 

A support vector machine (SVM) is an example of a classifier that can be 
employed. The SVM operates by finding a hypersurface in the space of possible inputs, 
'5- which hypersurface attempts to split the triggering criteria from the non-triggering events. 
Intuitively, this makes the classification correct for testing data that is near, but not 
identical to training data. Other directed and undirected model classification approaches 
include, e.g., naive Bayes, Bayesian networks, decision trees, and probabilistic 
classification models providing different patterns of independence can be employed. 

10 Classification as used herein also is inclusive of statistical regression that is utilized to 
develop models of priority. 

As will be readily appreciated from the subject specification, the subject invention 
can employ classifiers that are explicitly trained (e.g., via a generic training data) as well 
as implicitly trained (e.g., via observing user behavior, receiving extrinsic information). 

1 5 For example, SVM's are configured via a learning or training phase within a classifier 
constructor and feature selection module. Thus, the classified s) can be used to 
automatically perform a number of functions, including but not limited to determining 
according to a predetermined criteria what artifacts to expose, what priority can be 
applied for exposing artifacts, what tools should be exposed before other tools, what 

20 artifacts can be exposed based on the type of data, the user, and location of the data, for 
example. 

The Artifact/Link Cache 

The Artifact/Link cache is a centralized store into which artifacts and the links 
25 they hold are replicated to enable high performance query access. By gathering together 
brief artifact and link data into a single database, cross-service reference inversions can 
be processed much more efficiently. 

Referring now to FIG. 1 1 , there is illustrated a flow chart of a process for one 
implementation of a cache in accordance with the present invention. At 1 100, a cache is 
30 employed to store artifact/link relationships. At 1 1 02, the relationship is formatted 
according to the GAS. At 1 104, updates to the cache are made in response to 
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ArtifactChanged events raised by artifact providers. An IS cache manager subscribes to 
ArtifactChanged and uses the event object, an object that conforms to the GAS, to update 
itself. Since the cache is updated asynchronous to actual artifact updates it can briefly be 
out-of-sync with the underlying store. However, the latency is short and is, for most 
"5- applications, acceptable. When zero latency is required, a tool can bypass the cache and 
make requests directly to a tool through its standard GetArtifacts / 
GetReferencingArti facts methods. The cache is stored in a database that conforms to the 
Generic Artifact Database schema. The cache differs from the GAP database in that the 
GAP database is the master copy of mapping information and links, while the cache 

1 0 database is the master for nothing, and is completely recreatable. 

Referring again to FIG. 1 1 , at 1 106, a determination is made as to whether the 
cache has been synchronized with the underlying data. In the event that, as a result of 
network or system failures, the cache and the underlying data fall permanently out-of- 
sync, IS provides an administrative SynchronizeArtifactCache utility that collaborates 

1 5 with each artifact provider to restore the cache. This utility invokes each artifact 

provider's SynchronizeArtifactCache method. If no synchronization is required, flow is 
from 1 106 to 1 104 to update the cache. If synchronization is required, flow is from 1 106 
to 1 108 to invoke synchronization. Cache synchronization behaves as follows. An IS 
SynchronizeArtifactCache utility is invoked (programmatically or through an 

20 administrative function). If a cache synchronization is already in progress, a warning is 
provided; however, the warning can be overridden. In a IS Administrative Database, the 
state "global synchronization in progress" is set. 

At 1110, each cached artifact to be synchronized (based on date range) is marked 
with a "to be cached" flag. At 1112, each provider is contacted that has artifacts that 

25 have been marked. The artifact provider's SynchronizeArtifactCache method is invoked 
and sets the state "<tool-instance> synchronization in progress" in the Administrative 
Database. At 1 1 14, the artifact provider's SynchronizeArtifactCache method issues a 
CacheArtifact event for each candidate artifact (or for a set of candidate artifacts). At 
1116, evented and marked artifacts are uploaded to the cache. When the artifact provider 

30 has issued CacheArtifact events for all candidate artifacts, it fires an EndCacheLoad 
event with its own tool instance as a parameter. The IS Cache Manager listens for 
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ArtifactChanged and CacheArtifact events. Both events are handled in the same way: 
each artifact included in the Artifacts parameter on the event is placed in the cache. 

At 1 1 1 8, if an artifact in the cache exists with the same URI, it is replaced. 
Otherwise it is added. Note that the replaced or added entries do not have their "to be 
cached" flags set. The IS Cache Manager listens for the EndCacheLoad event. When 
received, at 1 120, cache clean-up is performed such that all artifacts in the cache for the 
tool instance specified by EndCacheLoad that are marked "to be cached" are deleted. 
This removes any cached items whose corresponding artifacts have been deleted from 
their primary store. IS turns off the "<tool-instance> synchronization in progress" state. 
When the final provider's "<tool-instance> synchronization in progress" state is turned 
off, the "global synchronization in progress" state is turned off. The process then reaches 
a Stop block. 

API Reference 

This section includes all method signatures defined elsewhere in the document 
with a reference to the method's elaboration. Additionally, overloads for methods 
offered by IS are accompanied by a Message Qualifier. By convention in ASP.Net, an 
overloaded method's MessageName property is formed by concatenating the method 
name and the message qualifier, as illustrated below. These message names are invisible 
to consumers of the services. 

The following code represents that the message name defaults to the method 
name, in this case, GetArtifacts. 

[WebMethod] 

public ArtifactID GetArtifacts ( string [ ] ArtifactUri) 
{ /* Get Artifacts; use cache if possible */ } 

In the following, the message name is explicitly specified. By convention, it is 
formed by concatenating method names plus the message qualifier form the signature 
table. In this case, the message qualifier Direct, so the message name is 
GetArtifactsDirect. 
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[WebMethod(MessageName="GetArtifactsDirect") ] 
public ArtifactID GetArtif acts ( string [ ] ArtifactUri) 
{ /* Get Artifacts directly from artifact provider */ } 



5 Schemas and Data Types 

Generic Artifact Schema (GAS) and Artifacts Class: GAS is an XML schema that 
defines a generic format for a displayable artifact. The schema appears below and is 
followed by an explanation of each of its elements. When a GAS conformant document 
is deserialized into an object, the object takes the form shown in "The Artifacts Class". 
1 0 Note that in the APIs, the Artifacts object never appears; instead, an array of Artifact 
objects is used. 

<?xml version="l . 0" encoding="ut f-8 " ?> 
<xs : schema 

15 targetNamespace="http: //www . company . com/Tool /GenericArti fact Schema . xsd" 
el ementFormDef ault= "qualified" xmlns="http : //www. company . com/ Tool 
/GenericArtif actSchema . xsd" 

xmlns :mstns="http: //www. company . com/ Tool /GenericArtif actSchema . xsd" 
xmlns: xs="http: //www . w3 . org/2001 /XMLSchema "> 
20 <! — By declaring ISUri a simple type we can add validation later. — > 

<xs : simpleType name="ISUri "> 

<xs : restriction base="xs : string" /> 
</xs : simpleType> 

<! — Enumeration for usage in Artif actChanged event. --> 
25 <xs : simpleType name="ChangeType"> 

<xs : restriction base="xs : string "> 
<xs : enumeration value="Add" /> 
<xs : enumeration value="Change" /> 
<xs : enumeration value="Delete" /> 
30 <xs : enumeration value="NoChange" /> 

</xs : restriction> 
</xs : simpleType> 
<xs: element name="Artif acts"> 
<xs : complexType> 
35 <xs : sequence> 

<xs:element name="Artif act " type="Artif act " minOccurs-"l " 
maxOccurs="unbounded" /> 

</xs : sequence> 
</xs : complexType> 
40 </xs:element> 

<xs : complexType name="Artif act "> 
<xs : sequence> 

<xs: element name="Uri" type="ISUri" /> 
<xs: sequence minOccurs="0 " maxOccurs="l "> 
45 <xs: element name="Artif actTitle " type="xs : string" /> 

<xs : element name="Artif actTypeName" type="xs : string" /> 
<xs : element name="LastChangedOn" type="xs :dateTime" /> 
<xs : element name="LastChangedBy" type="xs : string" /> 
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<xs : element name="ExternalId" type="xs : string" 
minOccurs="0" maxOccurs=" 1 " /> 

<xs: element name="ExtendedAttributes " minOccurs="0 " 

maxOccurs="l n > 

<xs : complexType> 
<xs : sequence> 

<xs : element name="ExtendedAttribute" 
type="ExtendedAt tribute" minOccurs="0" 

maxOccurs="unbounded" /> 

</xs : sequence> 
</xs : complexType> 
</xs : element> 

<xs: element name="OutboundLinks" minOccurs="0" 

maxOccurs="l "> 

<xs : complexType> 
<xs : sequence> 

<xs : element name="OutboundLink" 
type="OutboundLink" minOccurs="0" 

maxOccurs= "unbounded" /> 
</xs : sequence> 
</xs : complexType> 
</xs : element> 
</xs : sequence> 
</xs : sequence> 

<xs : attribute name="ChangeType" type="ChangeType" 
def ault="NoChange" use="optional" /> 
</xs : complexType> 

<xs : complexType name="ExtendedAttribute"> 
<xs : sequence> 

<xs: element name="Name" type="xs : string" /> 

<xs: element name="Value" type="xs : string" /> 

<xs: element name="FormatString" type="xs : string" minOccurs 

/> 

</xs : sequence> 
</xs : complexType> 

<xs : complexType name="OutboundLink"> 
<xs : sequence> 

<xs: element name="LinkType" type="xs : string" /> 
<xs: element name="Ref erencedUri " type="ISUri" /> 
</xs : sequence> 
</xs : complexType> 
</xs : schema> 



Element Artifacts 

Contains 1 :m Artifact elements, each of which describes a generic IS artifact. 
One Artifact element per incoming Artifactld will be appear in the Artifacts element. 
Element Artifact 

Contains exactly one displayable Artifact which consists of the following sub- 
elements: 

- Uri: the Uri of the returned artifact. 
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- ArtifactTitle: the localized, friendly name of the returned artifact. 

- ArtifactTypeName: the localized, friendly name of the returned artifact's type. 

- LastChangedOn: date and time of last change, if available. 

- LastChangedBy: userld of last person to change this artifact, if available. 

- External Id: This element is reserved for use by the IS generic artifact provider. It 
contains information that enables IS and its agents to access an item that has no 
direct artifact provider. 

- Ex tended Attributes: a collection of name/value pairs that describe optional 
artifact-specific properties the provider may offer. 

1 0 - OutboundLinks: a collection of link type/referenced Uri pairs that describe an 
outbound link from this artifact. 

- ChangeType is an optional attribute on the Artifact element that is only 
meaningful in the context of the ArtifactChanged event. 



15 The Artifacts Class 



// 

// <autogenerated> 

// This code was generated by a tool. 

20 // Runtime Version: 1.1 

// 

// Changes to this file may cause incorrect behavior and will be 
// lost if the code is regenerated. 
// </autogenerated> 
25 // 

// 

// This source code was auto-generated by xsd, Version=l.l 
// 

using System. Xml . Serialization; 

30 

[System. Xml . Serialization .XmlTypeAttribute (Namespace="http : //www. compan 
y . com/Tool/GenericArtif actSchema . xsd") ] 

[ System. Xml .Serialization .XmlRoot At tribute (Namespace="http : //www . 
company . com/Tool /GenericArt if actSchema. xsd", IsNullable=f alse) ] 
35 public class Artifacts { 

[System. Xml . Serialization .XmlElement At tribute ( "Artifact" ) ] 
public Artifact [] Artifact; 

} 

40 

[System. Xml . Serialization. XmlTypeAttribute (Namespace="http : //www . 
company . com/Tool/GenericArtif actSchema . xsd" ) ] 
public class Artifact { 
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public string Uri; 

public string Artif actTitle; 

public string Artif actTypeName; 

public System. DateTime LastChangedOn; 

public string LastChangedBy; 

public string ExternallD; 

[System. Xml . Serialization . Xml Ar ray I temAt tribute ( IsNullable=f alse) ] 
public ExtendedAttribute [ ] ExtendedAttributes; 

[System. Xml . Serial i zat ion . Xml Arrayl temAt tribute ( IsNullable=f alse ) ] 
public OutboundLink [ ] OutboundLinks; 

[System. Xml . Serialization . Xml At tributeAt tribute ( ) ] 
public ChangeType ChangeType = ChangeType . NoChange; 

} 

[System. Xml . Serialization . XmlTypeAt tribute (Namespace="http : //www. 
company . com/Tool /GenericArt if act Schema . xsd") ] 
public class ExtendedAttribute { 

public string Name; 
public string Value; 
public string FormatString ; 

} 

[System. Xml . Serialization . XmlTypeAt tribute (Namespace="http : //www . 
company . com/Tool/GenericArtif actSchema .xsd" ) ] 
public class OutboundLink { 

public string LinkType; 
public string Ref erencedUri ; 

} 

[System. Xml . Serialization .XmlTypeAttribute (Namespace="http : //www. 
company . com/Tool/GenericArtif actSchema . xsd" ) ] 
public enum ChangeType { 

Add, 
Change, 
Delete, 
NoChange, 

} 



Generic Link Schema (GLS) and Links Class 

GLS is an XML schema that defines a generic format for artifact links. It is 
returned by the ExtractLinks method. The schema appears below and is followed by an 
explanation of each of its elements. When a GLS conformant document is deserialized 
into an object, the object takes the form shown under "The Links Class" sections. 
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<?xml version="l . 0" encoding="ut f-8 " ?> 
<xs : schema id="ISGenericLinkSchema" 

targetNamespace="http: //tempuri . org/ISGenericLinkSchema . xsd" 
elementFormDef ault= f 'qualified" 
-5 xmlns="http : //tempuri . org/ISGenericLinkSchema . xsd" 

xmlns :mstns="http: //tempuri . org/ISGenericLinkSchema . xsd" 
xmlns :xs="http: //www. w3 . org/200 l/XMLSchema"> 

<xs: element name="Links "> 
10 <xs : complexType> 

<xs : sequence> 

<xs: element name="Link" type="Link" minOccurs="l " 
maxOccurs= "unbounded" /> 

</xs : sequence> 
15 </xs : complexType> 

</xs : element> 

<xs : complexType name="Link"> 
<xs : sequence> 

<xs: element name="Ref erringUri " type="xs : string" /> 
20 <xs: element name="LinkType" type="xs : string" /> 

<xs: element name="Ref erencedUri " type="xs : string" /> 
</xs : sequence> 
</xs : complexType> 
</xs : schema> 

25 

Element Links 

Contains 1 :m Link elements, each of which describes a link between two IS 
artifacts. 
30 Element Link 

Describes one link between two artifacts: 

- ReferringUri: the Uri of the referring (consumer) artifact. 

- LinkType: the type of the link. 

- ReferencedUri: the URI of the referenced (provider) artifact. 

35 

The Links Class 

// 

// <autogenerated> 



40 // This code was generated by a tool. 

// Runtime Version: 1.1 
// 

// Changes to this file may cause incorrect behavior and will be 

// lost if the code is regenerated. 



45 // </autogenerated> 

// 

// 

// This source code was auto-generated by xsd, Version=l . 1 
// 

50 using System. Xml . Serialization; 
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[System. Xml . Serialization . XmlTypeAt tribute (Namespace="http : //tempuri . or 
g/ISGenericLinkSchema . xsd" ) ] 

[ System. Xml . Serialization . Xml Root At tribute (Namespace="http : //tempuri . or 
g/ISGenericLinkSchema.xsd", IsNullable=f alse) ] 
public class Links { 

[System. Xml . Serialization . XmlElement At tribute { "Link" } ] 
public Link[] Link; 

} 

[System. Xml . Serialization . XmlTypeAt tribute (Namespace="http : //tempuri . or 
g/ISGenericLinkSchema . xsd" ) ] 
public class Link { 

public string Ref erringUri ; 
public string LinkType; 
public string Ref erencedUri ; 

} 



LinkFilter Class 

The LinkFilter class is used in query methods to filter results. Each artifact 
consumer must respect the filter in its GetReferencingArtifacts implementation. 



public class LinkFilter 
{ 

public enum filterType 
{ 

Toollnstance, 
Artif actType, 
LinkType 

} 

public filterType Type; 
public string [] Values; 

} 



Artifactld Class 

The Artifactld class is used to collect data that is used to form an artifacts Uri 
using the EncodeUri and DecodeUri methods. 



public class Artifactld 
{ 

public string VisualStudioServerNamespace; 

public string Tool; 

public string Artif actType; 
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public string ToolSpecif icld; 

} 

Generic Artifact Database Schema 
5* The following is a depiction of the generic artifact database schema used both for 

' the Generic Artifact Provider and for the Artifact/Link Cache. Essentially, it is the 
database implementation of a GAS schema with the following exceptions: the rovider 
name and artifact type are not present. They are automatically derived from the URI 
when an artifact instance is read and are ignored when an artifact instance is written. 
10 Optional bit attribute "Sync Flag" is used only in the cache and holds the instance- 
specific synchronization state. 

Sample Computing System 

Referring now to FIG. 12, there is illustrated a block diagram of a computer 

1 5 operable to execute the disclosed architecture. In order to provide additional context for 
various aspects of the present invention, FIG. 12 and the following discussion are 
intended to provide a brief, general description of a suitable computing environment 1200 
in which the various aspects of the present invention can be implemented. While the 
invention has been described above in the general context of computer-executable 

20 instructions that may run on one or more computers, those skilled in the art will recognize 
that the invention also can be implemented in combination with other program modules 
and/or as a combination of hardware and software. 

Generally, program modules include routines, programs, components, data 
structures, etc., that perform particular tasks or implement particular abstract data types. 

25 Moreover, those skilled in the art will appreciate that the inventive methods can be 
practiced with other computer system configurations, including single-processor or 
multiprocessor computer systems, minicomputers, mainframe computers, as well as 
personal computers, hand-held computing devices, microprocessor-based or 
programmable consumer electronics, and the like, each of which can be operatively 

30 coupled to one or more associated devices. 

The illustrated aspects of the invention may also be practiced in distributed 
computing environments where certain tasks are performed by remote processing devices 
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that are linked through a communications network. In a distributed computing 
environment, program modules can be located in both local and remote memory storage 
devices. 

A computer typically includes a variety of computer-readable media. 

"5' Computer-readable media can be any available media that can be accessed by the 
computer and includes both volatile and nonvolatile media, removable and non- 
removable media. By way of example, and not limitation, computer readable media can 
comprise computer storage media and communication media. Computer storage media 
includes both volatile and nonvolatile, removable and non-removable media implemented 

1 0 in any method or technology for storage of information such as computer readable 

instructions, data structures, program modules or other data. Computer storage media 
includes, but is not limited to, RAM, ROM, EEPROM, flash memory or other memory 
technology, CD-ROM, digital video disk (DVD) or other optical disk storage, magnetic 
cassettes, magnetic tape, magnetic disk storage or other magnetic storage devices, or any 

1 5 other medium which can be used to store the desired information and which can be 
accessed by the computer. 

Communication media typically embodies computer-readable instructions, data 
structures, program modules or other data in a modulated data signal such as a carrier 
wave or other transport mechanism, and includes any information delivery media. The 

20 term "modulated data signal" means a signal that has one or more of its characteristics set 
or changed in such a manner as to encode information in the signal. By way of example, 
and not limitation, communication media includes wired media such as a wired network 
or direct-wired connection, and wireless media such as acoustic, RF, infrared and other 
wireless media. Combinations of the any of the above should also be included within the 

25 scope of computer-readable media. 

With reference again to FIG. 12, there is illustrated an exemplary environment 
1200 for implementing various aspects of the invention that includes a computer 1202, 
the computer 1202 including a processing unit 1204, a system memory 1206 and a 
system bus 1208. The system bus 1208 couples system components including, but not 

30 limited to, the system memory 1 206 to the processing unit 1 204. The processing unit 
1204 can be any of various commercially available processors. Dual microprocessors 
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and other multi-processor architectures may also be employed as the processing unit 
- 1204. 

The system bus 1 208 can be any of several types of bus structure that may further 
interconnect to a memory bus (with or without a memory controller), a peripheral bus, 
5" and a local bus using any of a variety of commercially available bus architectures. The 
system memory 1206 includes read only memory (ROM) 1210 and random access 
memory (RAM) 1212. A basic input/output system (BIOS) is stored in a non-volatile 
memory 1210 such as ROM, EPROM, EEPROM, which BIOS contains the basic 
routines that help to transfer information between elements within the computer 1202, 

10 such as during start-up. The RAM 1212 can also include a high-speed RAM such as 
static RAM for caching data. 

The computer 1202 further includes an internal hard disk drive (HDD) 1214 (e.g., 
EIDE, SATA), which internal hard disk drive 1214 may also be configured for external 
use in a suitable chassis (not shown), a magnetic floppy disk drive (FDD) 1216, (e.g., to 

1 5 read from or write to a removable diskette 1218) and an optical disk drive 1 220, (e.g. , 
reading a CD-ROM disk 1222 or, to read from or write to other high capacity optical 
media such as the DVD). The hard disk drive 1214, magnetic disk drive 1216 and optical 
disk drive 1220 can be connected to the system bus 1208 by a hard disk drive interface 
1224, a magnetic disk drive interface 1226 and an optical drive interface 1228, 

20 respectively. The interface 1224 for external drive implementations includes at least one 
or both of Universal Serial Bus (USB) and IEEE 1394 interface technologies. 

The drives and their associated computer-readable media provide nonvolatile 
storage of data, data structures, computer-executable instructions, and so forth. For the 
computer 1202, the drives and media accommodate the storage of any data in a suitable 

25 digital format. Although the description of computer-readable media above refers to a 
HDD, a removable magnetic diskette, and a removable optical media such as a CD or 
DVD, it should be appreciated by those skilled in the art that other types of media which 
are readable by a computer, such as zip drives, magnetic cassettes, flash memory cards, 
cartridges, and the like, may also be used in the exemplary operating environment, and 

30 further, that any such media may contain computer-executable instructions for 
performing the methods of the present invention. 
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A number of program modules can be stored in the drives and RAM 1212, 
including an operating system 1230, one or more application programs 1232, other 
program modules 1 234 and program data 1 236. All or portions of the operating system, 
applications, modules, and/or data can also be cached in the RAM 1212. 
"5' It is appreciated that the present invention can be implemented with various 

commercially available operating systems or combinations of operating systems. 

A user can enter commands and information into the computer 1202 through one 
or more wired/wireless input devices, e.g., a keyboard 1238 and a pointing device, such 
as a mouse 1240. Other input devices (not shown) may include a microphone, an IR 

10 remote control, a joystick, a game pad, a stylus pen, touch screen, or the like. These and 
other input devices are often connected to the processing unit 1204 through an input 
device interface 1242 that is coupled to the system bus 1208, but can be connected by 
other interfaces, such as a parallel port, an IEEE 1 394 serial port, a game port, a USB 
port, an IR interface, etc. 

1 5 A monitor 1244 or other type of display device is also connected to the system 

bus 1208 via an interface, such as a video adapter 1246. In addition to the monitor 1244, 
a computer typically includes other peripheral output devices (not shown), such as 
speakers, printers etc. 

The computer 1202 may operate in a networked environment using logical 

20 connections via wired and/or wireless communications to one or more remote computers, 
such as a remote computer(s) 1248. The remote computer(s) 1248 can be a workstation, 
a server computer, a router, a personal computer, portable computer, 
microprocessor-based entertainment appliance, a peer device or other common network 
node, and typically includes many or all of the elements described relative to the 

25 computer 1202, although, for purposes of brevity, only a memory storage device 1250 is 
illustrated. The logical connections depicted include wired/wireless connectivity to a 
local area network (LAN) 1252 and/or larger networks, e.g., a wide area network (WAN) 
1254. Such LAN and WAN networking environments are commonplace in offices, and 
companies, and facilitate enterprise-wide computer networks, such as intranets, all of 

30 which may connect to a global communication network, e.g., the Internet. 
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When used in a LAN networking environment, the computer 1202 is connected to 
the local network 1252 through a wired and/or wireless communication network interface 
or adapter 1 256. The adaptor 1 256 may facilitate wired or wireless communication to the 
LAN 1252, which may also include a wireless access point disposed thereon for 

5* communicating with the wireless adaptor 1256. When used in a WAN networking 
environment, the computer 1202 can include a modem 1258, or is connected to a 
communications server on the LAN, or has other means for establishing communications 
over the WAN 1254, such as by way of the Internet. The modem 1258, which can be 
internal or external and a wired or wireless device, is connected to the system bus 1208 

10 via the serial port interface 1242. In a networked environment, program modules 

depicted relative to the computer 1202, or portions thereof, can be stored in the remote 
memory/storage device 1250. It will be appreciated that the network connections shown 
are exemplary and other means of establishing a communications link between the 
computers can be used. 

15 The computer 1202 is operable to communicate with any wireless devices or 

entities operatively disposed in wireless communication, e.g., a printer, scanner, desktop 
and/or portable computer, portable data assistant, communications satellite, any piece of 
equipment or location associated with a wirelessly detectable tag (e.g., a kiosk, news 
stand, restroom), and telephone. This includes at least Wi-Fi and Bluetooth™ wireless 

20 technologies. Thus, the communication can be a predefined structure as with 

conventional network or simply an ad hoc communication between at least two devices. 

Wi-Fi, or Wireless Fidelity, allows connection to the Internet from a couch at 
home, a bed in a hotel room or a conference room at work, without wires. Wi-Fi is a 
wireless technology like a cell phone that enables such devices, e.g., computers, to send 

25 and receive data indoors and out; anywhere within the range of a base station. Wi-Fi 
networks use radio technologies called IEEE 802.1 1 (a, b, g, etc.) to provide secure, 
reliable, fast wireless connectivity. A Wi-Fi network can be used to connect computers 
to each other, to the Internet, and to wired networks (which use IEEE 802.3 or Ethernet). 
Wi-Fi networks operate in the unlicensed 2.4 and 5 GHz radio bands, with an 1 1 Mbps 

30 (802. 1 lb) or 54 Mbps (802. 1 1 a) data rate or with products that contain both bands (dual 
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band), so the networks can provide real-world performance similar to the basic lOBaseT 
wired Ethernet networks used in many offices. 

Referring now to FIG. 1 3, there is illustrated a schematic block diagram of an 
exemplary computing environment 1 300 in accordance with the present invention. The 
3" system 1300 includes one or more client(s) 1302. The client(s) 1302 can be hardware 
and/or software (e.g., threads, processes, computing devices). The client(s) 1302 can 
house cookie(s) and/or associated contextual information by employing the present 
invention, for example. The system 1300 also includes one or more server(s) 1304. The 
server(s) 1304 can also be hardware and/or software (e.g., threads, processes, computing 

10 devices). The servers 1304 can house threads to perform transformations by employing 
the present invention, for example. One possible communication between a client 1302 
and a server 1304 can be in the form of a data packet adapted to be transmitted between 
two or more computer processes. The data packet may include a cookie and/or 
associated contextual information, for example. The system 1300 includes a 

15 communication framework 1306 (e.g., a global communication network such as the 
Internet) that can be employed to facilitate communications between the client(s) 1302 
and the server(s) 1304. 

Communications can be facilitated via a wired (including optical fiber) and/or 
wireless technology. The client(s) 1302 are operatively connected to one or more client 

20 data store(s) 1 308 that can be employed to store information local to the client(s) 1 302 
(e.g., cookie(s) and/or associated contextual information). Similarly, the server(s) 1304 
are operatively connected to one or more server data store(s) 1310 that can be employed 
to store information local to the servers 1304. 

What has been described above includes examples of the present invention. It is, 

25 of course, not possible to describe every conceivable combination of components or 

methodologies for purposes of describing the present invention, but one of ordinary skill 
in the art may recognize that many further combinations and permutations of the present 
invention are possible. Accordingly, the present invention is intended to embrace all 
such alterations, modifications and variations that fall within the spirit and scope of the 

30 appended claims. Furthermore, to the extent that the term "includes" is used in either the 
detailed description or the claims, such term is intended to be inclusive in a manner 

48 



MS307207.01 

similar to the term "comprising" as "comprising" is interpreted when employed as a 
transitional word in a claim. 
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